home *** CD-ROM | disk | FTP | other *** search
/ Dr. Windows 3 / dr win3.zip / dr win3 / WINPROGS / SPMATE13.ZIP / README.DOC < prev    next >
Text File  |  1993-11-18  |  14KB  |  374 lines
  1.                   WELCOME TO Spelmate V1.3 FOR WINDOWS
  2.                   ------------------------------------
  3.  
  4. This README file contains important, last minute information about
  5. Spelmate V1.3 
  6.  
  7.  
  8. TABLE OF CONTENTS
  9. -----------------
  10.   1. What is Spelmate
  11.   2. How to Get Help
  12.   3. Installation
  13.   4. Important Notes
  14.   5. Files on the Disk(s)
  15.   6. Why Register?
  16.   7. History
  17.  
  18.  1. What is Spelmate
  19. --------------------
  20.  
  21. Spelmate is a DLL (Dynamic Link Library) that you can use to add spell
  22. checking to your Windows application. Because it is a DLL it can be called
  23. from any programming system that support DLL's including C,C++, Pascal,
  24. and Visual Basic.
  25.  
  26. Spelmate is available in Standard and professional versions. The Standard
  27. version comes with either an American of British dictionary (you specilfy), 
  28. and the profrssional version comes with both.
  29.  
  30. There is no royalty associated with Spelmate, and once you have registered
  31. the Shareware message will not be shown, and your users will be unaware of
  32. the origins of spelmate.
  33.  
  34. A number of sample programs in Borland C++, Borland Pascal, and Visual Basic 
  35. are included to illustrate how to use Spelmate. Spelmate is also used by
  36. Help Edit, a Windows Help File generation system, also from Aciran Software Systems.
  37.  
  38.  2. HOW TO GET HELP
  39. -------------------
  40.  
  41.   If you have any problems, please read this file and the user guide, and if
  42.   you still have a question and need assistance, help is available from the
  43.   following source:
  44.  
  45.      Write to me at the following address:
  46.  
  47.      James Herron
  48.      29 Duncryne Place,
  49.      Bishopbriggs
  50.      Glasgow G64 2DP
  51.      Scotland
  52.      UK.
  53.  
  54.   Alternatively call me on 041 762 0967 between 6pm and 9pm Mon - Fri, or any
  55.   time at Weekends (within reason!). Answering machine available.
  56.  
  57.   If you have a modem you can leave me a message on the ShareWare Support BBS
  58.   in the UK on (0442) 891109 (3 lines). This BBS has a link to the Runway BBS
  59.   in the US on 215-623-6203.
  60.  
  61.   Alternatively log on to a local BBS that echos FIDO or ILINK and leave me
  62.   a message in one of the following conferences:
  63.  
  64.   FIDO
  65.   ----
  66.   Shareware (fido)
  67.   Windows (fido)
  68.   Windows Programming (fido)
  69.  
  70.   ILINK
  71.   -----
  72.   Shareware (Ilink)
  73.   Windows Application Development (Ilink)
  74.  
  75.  
  76.   If you are on Compuserve or CIX you can Email me at
  77.  
  78.            herron@comms.eee.strathclyde.ac.uk  
  79.  
  80.   This is on the JANET network but can be accessed via internet and
  81.   Compuserve.
  82.   
  83.   To access internet you may have to make modifications such as:
  84.  
  85.                >INTERNET:herron@comms.eee.strathclyde.ac.uk
  86.  
  87.    which I BELIEVE is the correct format from Compuserve.  
  88.  
  89.  
  90.  3. INSTALLATION
  91. ----------------
  92.   You should read the rest of this README file to get further
  93.   information about this release before you do the installation.
  94.  
  95.   To perform the installation insert the floppy in drive A or B and run
  96.   INSTALL from Windows.
  97.   
  98.   This completes installation, you should now put your original disk(s) in a
  99.   save place. Start Windows and either run the demos from the Program Manager by
  100.   opening the File menu and selecting Run, or better still if you installed a
  101.   new group for Spelmate during install select it's icon for the application.
  102.  
  103.  4. IMPORTANT NOTES
  104. -------------------
  105.   o The Executable, dictionary and the Demo files in this package are
  106.     compressed. If you don't use the installation program or you need to
  107.     copy one of the original files onto your hard disk, use the UNPACK.EXE
  108.     file located on the distribution disk. This is a Windows application.
  109.  
  110.  
  111.  5. FILES ON THE DISK(S).
  112. -------------------------
  113.  
  114. Disk 1
  115.  
  116.   INSTALL  EXE    -  Windows Install Program
  117.   INSTALL  INF    -  Windows Install Script file
  118.   UNPACK   EXE    -  Unpack Utility.
  119.   README   DOC    -  This file
  120.   SPELMATE DL$    -  Spelmate DLL.
  121.   MAINxx   DI$    -  Main dictionary, either mainuk.dic or mainus.dic.
  122.   SPELMATE HL$    -  Spelmate user guide, this is a windows Help file.
  123.   SPELLAPP.EX$    -  Pascal Spell Editor
  124.   SPELLAPP.PA$    -  Pascal Spell Editor source
  125.   SPELLWND.PA$    -  Pascal Editor source
  126.   SPELLWND.RE$    -  Pascal Editor resource
  127.   SPELCHECK.EX$   -  Pascal File Speller
  128.   SPELCHECK.PA$   -  Pascal File Speller source
  129.   SPELL.PA$       -  Pascal Import Library
  130.   SPELFILE.RE$    -  Pascal Checker resource
  131.   INVOICE.DOC     -  Invoice/Order Form
  132.   FILEMENU.RC$    -  C Sample Filemenu resource
  133.   OWL.DE$         -  C Sample Owl def
  134.   SPELL.CP$       -  C Sample Spell.cpp
  135.   SPELL.IC$       -  C Sample Spell icon
  136.   SPELL.H$        -  C Sample Spell.h header
  137.   SPELLTST.EX$    -  C Spell Editor
  138.   SPELLTST.H$     -  C Sample header
  139.   SPELLTST.CP$    -  C Spell Editor source
  140.   SPELLTST.PR$    -  C Spell Editor project
  141.   SPELLTST.RC$    -  C Spell Editor resource
  142.   SPELMATE.BA$    -  Visual Basic interface
  143.   SPELMATE.H$     -  C Spelmate header
  144.   SPELMATE.LI$    -  C Import Library
  145.   GETFILE.FR$     -  VB Getfile form
  146.   SPELTEST.EX$    -  VB Spell Tester
  147.   SPELTEST.BA$    -  VB source
  148.   SPELTEST.MA$    -  VB Make File/Project
  149.   SAVEFILE.FR$    -  VB Savefile form
  150.   BOOK01A.IC$     -  VB Book Icon for examples
  151.   VBREADME.TX$    -  VB ReadMe File
  152.   VBSPLMIN.EX$    -  VB Min Example
  153.   VBSPLMIN.FR$    -  VB Min Form
  154.   VBSPLMIN.MA$    -  VB Min MakeFile
  155.  
  156. Note: all files whose extension ends in a $ are compressed.
  157.  
  158.  
  159. 6. Why Register?
  160. ----------------
  161.  
  162. Registering brings with it a number of advantages.
  163.  
  164. First of all the Unregistered Copy notice will no longer appear.
  165.  
  166. Second you will have technical support should you have any problems.
  167.  
  168. Third, your support will encourage me to continue to improve Spelmate.
  169.  
  170. And Finally, as a registered user you will be entitled to FREE updates for
  171. 6 months, and to favourable price reductions on future versions after that
  172. period. So make sure you complete the registration form as completely
  173. as possible.
  174.  
  175. 7. History
  176. ----------
  177. NB. Dates are in dd/mm/yy
  178.  
  179. 02/6/93 V1.0
  180. Initial release of Spelmate.
  181.  
  182.  
  183. 23/07/93 V1.1
  184.  
  185. Improved reliability by having Spelmate check the validity of the private
  186. dictionary, and deleting it if it is corrupt. Also a backup private
  187. dictionary was introduced to replace the corrupt one if needed.
  188.  
  189. This is not a bad reflection of V1.0, it is simply that if your Application
  190. should crash during development,(don't they all!), it would leave the DLL in
  191. an unstable state, and usually corrupt the private dictionary. Spelmate
  192. would then not function correctly until this dictionary was deleted. It was
  193. not essential for your App to be spell checking at the time, the fact that
  194. it 'owned' the DLL at the time of it's demise was enough. These problems
  195. have now been overcome (by means of validation and backup) without any user
  196. intervention.
  197.  
  198. Spelmate V1.0 did not work correctly with C programs as the Boolean function
  199. SpellCheck returned a Pascal Boolean (byte) value, and not a 16 bit (word)
  200. value. It now uses a BOOL Windows (16bit word) value.
  201.  
  202. Spelmate V1.0 did not work with Visual Basic. This is because the function
  203. suggestWord expects a pointer to a string, and returns a pointer, and VB
  204. works with strings or arrays. This has been overcome with the addition of a
  205. new function SuggestVBWord which takes a string.
  206.  
  207. Murphy's Law states that the spell checking dialog box will nearly always
  208. manage to cover up the users view of the word you are trying to check.
  209.  
  210. Spelmate V1.0 allowed Windows to place the dialog box. V1.1 always places it
  211. in the bottom centre of the screen. Unless of course you call the procedure
  212. DisplayAtTop just before hand. You have to work out which half of the screen
  213. your word is in, then place the dialog box in the other. This is illustrated
  214. by a C and Pascal example.
  215.  
  216. Special thanks to Alistair McMonnies and Stewart McSporran of MEDC for the 
  217. C++ and VB examples.
  218.  
  219. 04/10/93 V1.2
  220.  
  221. Bug fix in Pascal file Spell checker, V1.1 does not automatically initialise
  222. Spelmate.
  223.  
  224. Bug fix in Visual Basic Text file editor. If cursor at first position and
  225. select spell check from cursor, got an invalid r